home *** CD-ROM | disk | FTP | other *** search
/ Beginning Mac Programming / Beginning Mac Programming.bin / Open Me for REALbasic 3 / REALbasic 3.2 / Example Projects / Techniques / Examples by Thomas Tempelmann / TT's Icons-Plugin / TT's Icons-Plugin - ReadMe < prev   
Text File  |  1999-07-01  |  3KB  |  70 lines
  1. TT's Icons-Plugin for REALbasic
  2.  
  3. General Information
  4.  
  5. By Thomas Tempelmann
  6. Current version: 1.0 (April 6, 1999)
  7.  
  8. This is freeware. Use it as you like.
  9. (And if you have created some nice things, think about sharing them, too!)
  10.  
  11. This is a Plugin for REALbasic. Plugins contain usually low-level code that cannot be written using the REALbasic language directly.
  12.  
  13. The plugin and the sample RB program were created using CodeWarrior Pro 3 and REALbasic 1.1.1, tested on PowerPC computers running OS 8.5.
  14.  
  15. More REALbasic examples can be found on my Web Site at
  16.  
  17.   <http://www.tempel.org/rb>
  18.  
  19. Enjoy!
  20.  
  21.  
  22. Overview
  23.  
  24. To install, put the file TT's Icons-Plugin into the Plugins folder where your REALbasic application resides (quit REALbasic first, if it is running).
  25.  
  26. Installation
  27.  
  28. 1. Quit REALbasic if it is running
  29.  
  30. 2. Place the file TT's Icons-Plugin into a folder called Plugins, that resides in the same folder where your REALbasic application is.
  31.  
  32. 3. Now you can launch REALbasic again and the methods described below will be available for your RB applications and the enclosed demo code.
  33.  
  34. Plugin Functions
  35.  
  36. The current version has only one function:
  37.  
  38. • IconToPict(icon as String, bitDepth as Integer, pixelSize as Integer) as Picture
  39.  
  40. Converts an icon into a Picture so that you can display it within the REALbasic environment.
  41.  
  42. To see how it is used, look at the method DisplayTheFileIcon in the included REALbasic demo project.
  43.  
  44. Note: Currently this function only creates a Picture from the Icon's Image, and does not consider the Icon Mask. The Mask is always right behind the Icon Image, in case you want to get that, too.
  45.  
  46. Note on adding more functionality
  47.  
  48. If you add more functions to this plugin, please send a copy to me and let me know if you like me to add them to my version on the web, so that others can benefit of the enhancements, too.
  49.  
  50. If you decide to publish an updated version by yourself, please give me credits (that means: mention where you got the initial code from).
  51.  
  52. Plugin Programming Information
  53.  
  54. The plugin code is a Metrowerks CodeWarrior Pro 3 (IDE 3.1) project.
  55. If you have an older CW version that refuses to open the prj file, then create a new and set/enable the following prj options:
  56. • create 68K target (set to 68K linker)
  57. • prj type: Code Resource, File Name "CatalogSearch-Plugin", Creator "SfTg", Type "RBPl", ResType "PL68", ResID "128", Extended Resource, Header Type "Standard"
  58. • C/C++ language settings: Prefix File "MacHeaders.h"
  59. • 68K Processor: 68020 Codegen, Code Model "Smart", Struct Alignm. "PowerPC", 4-Byte Ints, 8-Byte Doubles, MPW C Call. Conv.
  60. • 68K Linker: Link Single Segment, Merge Compiler Glue…, Dead-strip Static Init Code
  61. • Add the files "Plugin Source.cpp", "PluginMain.cpp", "MacOS.lib", "Version Info.rsrc" and a 68K C lib with (4i_8d) in its name to the project.
  62.  
  63. To compile the project, you also need to have the "Plugin SDK" available, which you can download from RB's website.
  64.  
  65.  
  66. Revision history
  67.  
  68. April 6 99, v1.0:
  69.     First release.
  70.